home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / old-compression / cl_jpeg.z / cl_jpeg
Encoding:
Text File  |  1998-10-20  |  5.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ccccllll____jjjjppppeeeegggg((((3333ddddmmmm))))                                                      ccccllll____jjjjppppeeeegggg((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cl_jpeg - JPEG schemes in the Compression Library
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ccccllll....hhhh>>>>
  13.  
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      The JPEG compression standard, jpeg(4), is supported in the Compression
  17.      Library, CLintro(3dm), with two schemes
  18.  
  19.      1. CCCCLLLL____JJJJPPPPEEEEGGGG____SSSSOOOOFFFFTTTTWWWWAAAARRRREEEE    software implementation
  20.      2. CCCCLLLL____JJJJPPPPEEEEGGGG____CCCCOOOOSSSSMMMMOOOO       real-time hardware device
  21.  
  22.      Each scheme is accessed using the basic CL API and parameter set.  This
  23.      man page describes the additional, JPEG-specific, parameters that are
  24.      common to both schemes.
  25.  
  26.      Note that there are two methods of controlling the quantization tables.
  27.      An overall quality rating can be specified that will be used to scale a
  28.      default set of quantization tables, or alternatively, the quantization
  29.      tables may be manually specified.
  30.  
  31.      CCCCLLLL____JJJJPPPPEEEEGGGG____QQQQUUUUAAAALLLLIIIITTTTYYYY____FFFFAAAACCCCTTTTOOOORRRR
  32.           Type: CL_RANGE_VALUE
  33.           This is one method to control the image loss and therefore the
  34.           compression ratio.
  35.  
  36.           The quality factor controls the scaling of the quantization
  37.           tables and thereby represents a rough percentage of image detail
  38.           preservation.  Each time the quality factor is set, the reference
  39.           quantization tables are scaled and downloaded into the codec.
  40.  
  41.           The formula used to obtain the scale factor is
  42.                scalefactor = 50/quality          (quality < 50)
  43.                scalefactor = 2 - 2*quality/100;  (otherwise)
  44.  
  45.           A value of 1 causes very coarse quantization and results in a high
  46.           compression ratio, the image quality is practically useless.
  47.  
  48.           A value of 100 causes the codec to quantize as finely as possible,
  49.           often resulting in image expansion and near-perfect quality.
  50.  
  51.           A value of CL_JPEG_QUALITY_NO_SCALE will bypass any scaling.
  52.           The default quality is CL_JPEG_QUALITY_DEFAULT and represents
  53.           a good quality compressed image.
  54.  
  55.           A typical useful range is 25-95.
  56.  
  57.           When CL_QUALITY_FACTOR is set, the approximate value of
  58.           CL_COMPRESSION_RATIO is calculated and when CL_COMPRESSION_RATIO
  59.           is set, the approximate value of CL_QUALITY_FACTOR is calculated.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccllll____jjjjppppeeeegggg((((3333ddddmmmm))))                                                      ccccllll____jjjjppppeeeegggg((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.           When decompressing JPEG, clDecompress() fills this value in.
  75.  
  76.      CCCCLLLL____JJJJPPPPEEEEGGGG____QQQQUUUUAAAANNNNTTTTIIIIZZZZAAAATTTTIIIIOOOONNNN____TTTTAAAABBBBLLLLEEEESSSS
  77.           Type: CL_RANGE_VALUE
  78.           Sets or gets the quantization tables to be used.  For setting,
  79.           an unsigned short *qtables[4] argument is specified as the
  80.           parameter value.  For each j, qtables[j] must either be NULL or
  81.           point to a unsigned short[64] area of memory which represents
  82.           a JPEG baseline (values from 0-255) quantization table in natural
  83.           scan order.  The user specified tables are stored as reference
  84.           tables and scaled versions of them based on the current
  85.           CL_JPEG_QUALITY_FACTOR are downloaded into the codec and become
  86.           the table associated with id j.   For getting, the library returns
  87.           a pointer to static memory containing a similar array of four
  88.           points.
  89.  
  90.  
  91.  
  92. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  93.      The CL programming interface is supported on the following platforms:
  94.      Cosmo Compress for Indy and Indigo2 for use with Indy Video, Galileo
  95.      Video, Indigo2 Video, Impact Video and Octane Compression.
  96.  
  97.      The CL is NNNNOOOOTTTT supported on O2.  Refer to ddddmmmm____jjjjppppeeeegggg for information on
  98.      programming the built-in compression hardware on O2.
  99.  
  100.  
  101. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  102.      jpeg(4), CLintro(3dm), cl_cosmo(3dm)
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.